クレジットカード インタフェース
概要
リンクタイプ Plus決済では、決済手段としてクレジットカード決済を利用することが可能です。クレジットカード決済を利用するには、実行パラメータセットにクレジットカード決済に必要なパラメータを渡す必要があります。
実行パラメータセットで会員IDを指定すると、会員IDに登録されているカード番号を表示、決済することができます。
リンクタイプ Plus決済でクレジットカード決済が完了すると、遷移先URLにクレジットカード決済の結果パラメータが返却されます。
遷移先URLは設定により異なるパラメータを参照します。
詳細は「決済画面からの加盟店様サイトへの遷移」をご覧ください。
入出力パラメータ仕様
実行パラメータ仕様
クレジットカード決済固有の実行パラメータは以下の通りです。
| json key | 詳細 | 指定可能箇所 | システムデフォルト設定 | ||
|---|---|---|---|---|---|
| リンクタイプPlus決済URL | 加盟店デフォルト設定 | ||||
| credit |
クレジットカード決済固有実行パラメータクレジットカード決済の実行パラメータセットです。 |
〇 | 〇 | ||
| JobCd |
処理区分以下のいずれかを設定します。AUTH：仮売上 CAPTURE：即時売上 |
〇 | 〇 | AUTH | |
| Method | 半角数字1桁
支払方法（単一指定）以下のいずれかを設定します。1：一括 2：分割 3：ボーナス一括 5：リボ 利用可能な支払方法を選択してください。 |
〇 | 〇 | (null) | |
| Methods | 半角数字1桁
支払方法（複数指定）以下の中から任意の支払方法を複数指定できます。1：一括 2：分割 3：ボーナス一括 5：リボ 利用可能な支払方法を複数選択してください。 例：["1","2","3"] MethodとMethodsどちらも指定した場合、Methodsが適用されます。 指定した支払方法の契約がない場合、画面に表示されません。 |
〇 | 〇 | (null) | |
| PayTimes | 半角数字2桁
支払回数支払方法に「2:分割」を指定した場合、必ず設定してください。 |
〇 | 〇 | (null) | |
| ItemCode | 半角英数7桁
商品コード通常は省略してください。 |
〇 | 〇 | 0000990 | |
| TdFlag | 半角数字1桁
本人認証サービス利用フラグ本人認証サービスを使用して決済を行うかを指定します。以下のいずれかを設定します。 0：【利用しない】 3Dセキュア認証せず、決済をします。 1：【3DS1.0を利用する】 3DS1.0認証サポート終了のため、指定しないでください。 ・指定した場合、ショップの「3DS1.0認証（サポート終了）の取り扱い」の設定に従います。 2：【契約に従う】 3Dセキュア（本人認証）のご契約に従います。 ・ご契約されている場合には3Dセキュア認証実施のうえ、決済をします。 ・ご契約されていない場合には3Dセキュア認証せず、決済をします。 3：【3DS2.0を利用する】 3Dセキュア2.0認証実施のうえ、決済をします（ご契約されていない場合には、エラーとなります）。 |
〇 | 〇 | 2 | |
| TdTenantName | 半角英数記号25桁
3Dセキュア表示店舗名3Dセキュア画面に表示する店舗名を指定します。EUC-JPでBASE64エンコーディングした値を指定します（日本語も使用可能ですが、文字化けが起こりやすいので使用する場合は十分な検証を実施してください。）。 省略時は店舗名が「未指定」となります。 |
〇 | 〇 | (null) | |
| MemberID | 半角英数記号60桁
会員ID会員IDに登録されているカード番号を表示したい場合に指定します。 |
〇 | - | (null) | |
| SecCodeRequiredFlag | 半角数字1桁
セキュリティコード必須フラグONにすると、セキュリティコードの入力が必須になります。0:OFF（任意入力） 1:ON（必須入力） |
〇 | 〇 | 0 | |
| SecCodeHiddenFlag | 半角数字1桁
セキュリティコード非表示フラグONにすると、セキュリティコード入力欄が非表示になります。0:OFF（表示する） 1:ON（表示しない） |
〇 | 〇 | 0 | |
| Tds2Type | 半角数字1桁
3DS2.0未対応時取り扱い3DS2.0未対応カード時の後続処理について指定します。1:3DS1.0での認証を実施 2:エラーとして処理終了 3:通常オーソリを実施 3DS1.0認証サポート終了のため、1以外を指定してください。 |
〇 | 〇 | 1 | |
| RegistMemberID | 半角英数記号60桁
決済後カード登録時会員ID決済後カード登録を行う場合の、カードを登録する会員IDを指定します。本パラメータを指定し、かつお客様がクレジットカード情報の登録を許可した場合、 決済成功後、指定した会員IDにクレジットカード情報が登録されます。 会員が存在しない会員IDを指定した場合、会員登録も行われます。 |
〇 | - | (null) | |
| CardInputHiddenFlag | 半角数字1桁
カード番号入力欄非表示フラグONにすると、会員IDにカード番号が登録されている場合、カード番号入力欄を非表示とし、会員IDに登録済みのカードのみ選択可能となります。0:OFF（表示する） 1:ON（表示しない） |
〇 | 〇 | 0 | |
| CardMaxCnt | 半角数字1桁
最大カード登録枚数決済後カード登録でカード登録をする場合、1会員で登録可能な最大カード枚数を指定することができます。指定可能な値は1~5までになります。 決済後カード登録時会員IDを指定した場合のみ、本パラメータが使用されます。 ※カード編集機能と決済後カード登録機能を併用しており、両機能で最大カード登録枚数を制御したい場合、カード編集機能と決済後カード登録機能の両方で設定が必要となります。 |
〇 | 〇 | (null) | |
実行パラメータ仕様（3DS2.0）
3DS2.0専用のパラメータは以下の通りです。決済URL取得API実行時のみ、指定可能です。
| json key | 詳細 | 指定可能箇所 | システムデフォルト設定 | ||
|---|---|---|---|---|---|
| リンクタイプPlus決済URL | 加盟店デフォルト設定 | ||||
| Tds2ChAccChange | 半角数字8桁 固定
カード会員最終更新日カード会員情報の最終更新日を設定します。YYYYMMDD形式で設定してください。 |
〇 | - | (null) | |
| Tds2ChAccDate | 半角数字8桁 固定
カード会員作成日カード会員の作成日を設定します。YYYYMMDD形式で設定してください。 |
〇 | - | (null) | |
| Tds2ChAccPwChange | 半角数字8桁 固定
カード会員パスワード変更日カード会員のパスワード変更日を設定します。YYYYMMDD形式で設定してください。 |
〇 | - | (null) | |
| Tds2NbPurchaseAccount | 半角数字4桁
過去6ヶ月間の購入回数過去6ヶ月間に、このカード会員が購入した回数を設定します。 |
〇 | - | (null) | |
| Tds2PaymentAccAge | 半角数字8桁 固定
カード登録日カード会員にカード情報が登録された日付を設定します。YYYYMMDD形式で設定してください。 |
〇 | - | (null) | |
| Tds2ProvisionAttemptsDay | 半角数字3桁
過去24時間のカード追加の試行回数過去24時間に行われたカード情報追加の試行回数を設定します。 |
〇 | - | (null) | |
| Tds2ShipAddressUsage | 半角数字8桁 固定
配送先住所の初回使用日取引で使用される配送先住所が加盟店様で最初に使用された日付を設定します。YYYYMMDD形式で設定してください。 |
〇 | - | (null) | |
| Tds2ShipNameInd |
カード会員名と配送先名の一致/不一致カード会員の会員名と取引に使用される配送先名の一致/不一致を設定します。01:カード会員名と配送先名が一致 02:カード会員名と配送先名が不一致 |
〇 | - | (null) | |
| Tds2SuspiciousAccActivity |
カード会員の不審行為情報カード会員で、不審な行動（過去の不正行為を含む）を加盟店様が発見したかどうかを設定します。01:不審な行動は見られなかった 02:不審な行動が見られた |
〇 | - | (null) | |
| Tds2TxnActivityDay | 半角数字3桁
過去24時間の取引回数過去24時間に行われた、カード会員と加盟店様との取引の回数を設定します。 |
〇 | - | (null) | |
| Tds2TxnActivityYear | 半角数字3桁
前年の取引回数前年に行われた、カード会員と加盟店様との取引の回数を設定します。 |
〇 | - | (null) | |
| Tds2DeliveryEmailAddress | 半角英数記号254桁
納品先電子メールアドレス電子デリバリーの場合、商品を納品したときの納品先電子メールアドレスを設定します。 |
〇 | - | (null) | |
| Tds2DeliveryTimeframe |
商品納品時間枠商品納品時間枠を設定します。01:電子デリバリー 02:当日出荷 03:翌日出荷 04:2日目以降の出荷 |
〇 | - | (null) | |
| Tds2GiftCardAmount | 半角数字15桁
プリペイドカードまたはギフトカードの総購入金額プリペイドカードまたはギフトカードを購入の場合、総購入金額の小数点以上の値を設定します。 |
〇 | - | (null) | |
| Tds2GiftCardCount | 半角数字2桁
購入されたプリペイドカードまたはギフトカードの総数プリペイドカードまたはギフトカードを購入の場合、購入された総数を設定します。 |
〇 | - | (null) | |
| Tds2GiftCardCurr | 半角数字3桁 固定
購入されたプリペイドカードまたはギフトカードの通貨コードプリペイドカードまたはギフトカードを購入の場合、カードの通貨を表す、ISO 4217で定義されている通貨コードを設定します。※以下のコードは対象外です。 955, 956, 957, 958, 959, 960, 961, 962, 963, 964, 999 |
〇 | - | (null) | |
| Tds2PreOrderDate | 半角数字8桁 固定
商品の発売予定日先行予約購入の場合は、商品の発売予定日を設定します。YYYYMMDD形式で設定してください。 |
〇 | - | (null) | |
| Tds2PreOrderPurchaseInd |
商品の販売時期情報先行予約購入か、発売済み商品の購入かを設定します。01:発売済み商品 02:先行予約商品 |
〇 | - | (null) | |
| Tds2ReorderItemsInd |
商品の注文情報カード会員が以前購入した商品を再び注文しているかどうかを設定します。01:初回注文 02:再注文 |
〇 | - | (null) | |
結果パラメータ仕様
クレジットカード決済を選択した場合に、加盟店様に返却するクレジットカード決済固有の結果パラメータは以下の通りです。
| credit |
クレジットカード決済固有部クレジットカード決済固有の結果パラメータセットです。 |
|||||||
|---|---|---|---|---|---|---|---|---|
| Status |
取引状態取引の状態を示す以下の値が設定されます。AUTH:仮売上 CAPTURE:即時売上 UNPROSESSED:未決済（オーソリエラー等で決済が完了していない状態） AUTHENTICATED:未決済（3D登録済） |
|||||||
| Forward | 半角英数7桁
仕向先コード与信を行ったカード会社の会社コードが設定されます。 |
|||||||
| Method | 半角数字1桁
支払方法お客様が選択した支払方法が設定されます。 |
|||||||
| PayTimes | 半角数字2桁
支払回数お客様が選択した支払回数が設定されます。 |
|||||||
| TranID | 半角英数28桁
トランザクションID弊社が処理を行うごとに発行している処理番号が設定されます。 |
|||||||
| TranDate | 半角数字14桁 固定
決済日時与信を行った日時が設定されます。（yyyyMMddHHmmss形式) |
|||||||
| Approve | 半角英数7桁
承認番号カード会社が発行した与信の承認番号が設定されます。 |
|||||||
| registcard |
決済後カード登録固有部決済後カード登録固有の結果パラメータセットです。決済後カード登録時会員IDが指定され、かつお客様がクレジットカード情報の登録を許可した場合 クレジットカード決済固有部と共に加盟店様に返却します |
|||||||
| SiteID | 半角英数13桁
サイトIDカードを登録した会員に紐付くサイトIDが設定されます。 |
|||||||
| MemberID | 半角英数記号60桁
会員ID指定した決済後カード登録時会員IDが設定されます。 |
|||||||
| CardSeq | 半角数字4桁
カード登録連番登録したカードの論理連番が設定されます。 |
|||||||
| CardNo | 半角数字16桁
カード番号登録したカード番号をマスクした値が設定されます。 |
|||||||
| Result |
決済後カード登録処理結果決済後カード登録の処理結果(状態)が設定されます。
|
|||||||